home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / os2 / ssaver26.zip / INSTALL.HLP (.txt) < prev    next >
OS/2 Help File  |  1996-10-02  |  13KB  |  356 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. ScreenSaver Installation Program ΓòÉΓòÉΓòÉ
  3.  
  4. Use the Source directory entry field to set the directory from which 
  5. ScreenSaver is to be installed. Default is the current directory and there 
  6. should be no need to change this. 
  7.  
  8. Use the Destination directory entry field to set the directory into which 
  9. ScreenSaver is to be installed. Default is the current directory (except when 
  10. this is on a diskette). You can change this to any drive and directory you 
  11. want. 
  12.  
  13. Use the Destination directory for DLLs entry field to set the directory into 
  14. which the EMX runtime DLLs (i.e. the files which contain the runtime library 
  15. for the EMX/GCC compiler, with which ScreenSaver was compiled) are to be 
  16. installed. These DLLs are required by many OS/2 programs and therefore should 
  17. be installed to a directory in your LIBPATH where they are found by these 
  18. programs. Default is the \OS2\DLL directory on your boot drive. Change this to 
  19. any directory you want, but make sure this directory can be found in the 
  20. LIBPATH statement in your CONFIG.SYS file. 
  21. It is possible that there is more than one set of these DLLs installed on your 
  22. computer. Only one set of the DLLs is required system wide. You can delete all 
  23. but the newest set. 
  24.  
  25. Attention! If there are any programs running that use existing EMX DLLs on your 
  26. hard disk, you have to stop them or installation will fail. Alternatively 
  27. choose another DLL destination directory. 
  28. If you have an older version of ScreenSaver running, shut it down before trying 
  29. to install. It may even be necessary to reboot your computer, because OS/2 may 
  30. have locked the ScreenSaver file SSDLL.DLL (this can happen even if ScreenSaver 
  31. has been stopped). 
  32.  
  33. If the Create WPS object box is checked, a program object is created. If the 
  34. Create in startup folder box is checked, too, this object is created in the 
  35. OS/2 System Startup folder, so ScreenSaver will be started automatically at 
  36. system startup. 
  37.  
  38. Use the Install Win-OS/2 fullscreen support check box to choose if you want 
  39. ScreenSaver to be activated from Win-OS/2 fullscreen sessions. If you choose to 
  40. install this option, a Windows screen saver is installed in your Win-OS/2 
  41. directory. Use the Win-OS/2 "Control Panel" to set its timeout. Please set the 
  42. directory where Win-OS/2 is installed in the Win-OS/2 directory entry field. 
  43.  
  44. Use the Install DOS fullscreen support check box to choose if you want 
  45. ScreenSaver to be activated from DOS fullscreen sessions. If you choose to 
  46. install this option, a DOS screen saver is installed in your OS/2 DOS directory 
  47. (\OS2\MDOS). It is invoked from the AUTOEXEC.BAT file of your OS/2 boot drive. 
  48. Set the timeout parameter in the AUTOEXEC.BAT file; for example "SSDKICK 10" 
  49. sets the timeout for DOS fullscreen sessions to 10 minutes. The default timeout 
  50. is 5 minutes. To disable the DOS saver, set timeout to 0. 
  51.  
  52.  
  53. ΓòÉΓòÉΓòÉ 2. ScreenSaver Installation Notes ΓòÉΓòÉΓòÉ
  54.  
  55. IMPORTANT INFORMATION. PLEASE READ! 
  56.  
  57.      If you use OS/2 2.x, make sure there is a dot (".") in the LIBPATH 
  58.       statement in your CONFIG.SYS file (this is default in Warp). 
  59.  
  60.      If DPMS switching hangs your computer, try changing the BIOS power 
  61.       management settings; see ScreenSaver online help topic "Green monitor 
  62.       support". 
  63.  
  64.      ScreenSaver is Shareware. Some functions are available only to registered 
  65.       users. See online help or the file REGISTER.DOC for how to register. 
  66.  
  67.      ScreenSaver provides password protection. For the pre-set password, see 
  68.       online help. Please note that this password is case sensitive! If you 
  69.       have the impression that the system is not unlocked although you typed in 
  70.       the correct password, please check if Caps Lock is active. 
  71.  
  72.      There exists a little utility called SSKICK which starts a module when 
  73.       executed. You can add this utility to the Desktop menu (see online help). 
  74.  
  75.      For available command line switches, see online help. 
  76.  
  77.      In this distribution, I have included foreign modules. For copyright 
  78.       information see the README file. 
  79.  
  80.      A few users have reported problems with some Deskpic modules. If a 
  81.       Deskpic module crashes on your system, delete the corresponding *.DSS 
  82.       file. 
  83.  
  84.      Please read the online help topic on "low priority" if saver animation is 
  85.       not smooth enough. 
  86.  
  87.  
  88. ΓòÉΓòÉΓòÉ 3. Notes for CID installations ΓòÉΓòÉΓòÉ
  89.  
  90.      Overview 
  91.  
  92.         -  The installation program can be controlled by command line 
  93.            parameters and can run completely unattended. This makes 
  94.            installation over a network much easier. 
  95.         -  All settings which the user normally uses in the installation 
  96.            program are accessible through command line parameters. If a command 
  97.            line parameter is not given, a default value will be used (see 
  98.            below). 
  99.         -  There are some additional parameters, for example to exclude some 
  100.            files from being installed (if you want to spare certain modules). 
  101.         -  Installation can be done without any user interaction. A server can 
  102.            start the installation program on a client and is notified of 
  103.            success or failure by the return code of the installation program. 
  104.            In case of this unattended installation, the installation program 
  105.            does not expect user input, does not output error messages (except 
  106.            through its return code), and ends itself automatically after 
  107.            installation. A log file can be created. 
  108.  
  109.      Return codes of the installation program 
  110.  
  111.             0 - installation successful
  112.             1 - internal problem
  113.             2 - installation cancelled
  114.             3 - installation failed
  115.  
  116.      Command line parameters 
  117.  
  118.       Notes: 
  119.  
  120.         -  Command line parameters are not case-sensitive. 
  121.         -  If a parameter is not given, the installation program will choose a 
  122.            default value (see below). If you don't give any parameters at all, 
  123.            the installation program acts like in prior versions (<= 2.4). 
  124.         -  Instead of TRUE you can write YES, instead of FALSE you can write 
  125.            NO. 
  126.         -  There must not be a space after the '=' character. The value must 
  127.            follow immediately (see examples). 
  128.         -  The EXCLUDEFILES parameter must be the last parameter. 
  129.  
  130.       Supported command line parameters: 
  131.  
  132.             destpath=
  133.  
  134.       Description:             Directory where ScreenSaver will be installed to 
  135.       Value:                   Path 
  136.       Default:                 The current directory (except if the current 
  137.                                directory is on a diskette drive, in this case 
  138.                                another directory is chosen) 
  139.  
  140.             destpathdll=
  141.  
  142.       Description:             Directory where the EMX-DLLs will be copied to 
  143.       Value:                   Path 
  144.       Default:                 x:\OS2\DLL (x is the OS/2 boot drive) 
  145.  
  146.             sourcepath=
  147.  
  148.       Description:             Source path where the files to be installed can 
  149.                                be found 
  150.       Value:                   Path 
  151.       Default:                 Current directory 
  152.  
  153.             winos2path=
  154.  
  155.       Description:             Windows directory 
  156.       Value:                   Path 
  157.       Default:                 x:\OS2\MDOS\WINOS2 or the \WINDOWS directory on 
  158.                                the first drive (C..Z) where it exists 
  159.  
  160.             targetfolder=
  161.  
  162.       Description:             Folder where the ScreenSaver WPS object will be 
  163.                                created 
  164.       Value:                   Any valid folder name 
  165.       Default:                 "<WP_START>" 
  166.  
  167.             createobject=
  168.  
  169.       Description:             Create WPS object yes/no 
  170.       Value:                   TRUE or FALSE 
  171.       Default:                 TRUE 
  172.  
  173.             cmdline=
  174.  
  175.       Description:             Command line for ScreenSaver (will be set as 
  176.                                parameter in the WPS program object). Please 
  177.                                note that you have to enclose the cmdline= 
  178.                                parameter and its argument in double quotes if 
  179.                                the argument contains any space characters, i.e. 
  180.                                you have to write 
  181.                                install "cmdline=-I SSAVER.INI" 
  182.                                to get "-I SSAVER.INI" as the command line for 
  183.                                the WPS object. 
  184.       Value:                   Any valid command line, e.g. "-I SSAVER.INI" 
  185.       Default:                 No command line 
  186.  
  187.             installwinos2=
  188.  
  189.       Description:             Install WinOS/2 fullscreen support yes/no 
  190.       Value:                   TRUE or FALSE 
  191.       Default:                 TRUE 
  192.  
  193.             installdos=
  194.  
  195.       Description:             Install DOS fullscreen support yes/no 
  196.       Value:                   TRUE or FALSE 
  197.       Default:                 TRUE 
  198.  
  199.             unattendedinstallation=
  200.  
  201.       Description:             The installation program will run without user 
  202.                                input and will end itself when installation is 
  203.                                done 
  204.       Value:                   TRUE or FALSE 
  205.       Default:                 FALSE 
  206.  
  207.             logfile=
  208.  
  209.       Description:             All messages the installation program shows to 
  210.                                the user (and some other useful information) can 
  211.                                be logged to a log file. If the given file 
  212.                                already exists, the log information will be 
  213.                                appended. 
  214.       Value:                   File name ( including path) 
  215.       Default:                 No log file is created 
  216.  
  217.             extpasswordfile=
  218.  
  219.       Description:             The "external password file" which will be used 
  220.                                by ScreenSaver can be set already at 
  221.                                installation time. The given path will be 
  222.                                written to the OS2.INI file by the installation 
  223.                                program. If ScreenSaver is started with the -I 
  224.                                or -i parameter, the settings will be read from 
  225.                                the given INI file instead of OS2.INI and the 
  226.                                extpasswordfile= setting will have no effect. 
  227.       Value:                   Path 
  228.       Default:                 No external password file is set 
  229.  
  230.             os2drive=
  231.  
  232.       Description:             OS/2 boot drive. If you install from a server to 
  233.                                a workstation and want to run the installation 
  234.                                program on the server itself, you may need to 
  235.                                set the boot drive of the workstation. If you 
  236.                                run the installation program on the server, you 
  237.                                will not be able to create a WPS object on the 
  238.                                workstation. Installing this way is not 
  239.                                recommended. 
  240.       Value:                   Drive letter (C..Z) 
  241.       Default:                 The drive which is reported as boot drive by 
  242.                                OS/2 
  243.  
  244.             excludefiles
  245.  
  246.       Description:             To exclude certain modules from installation, 
  247.                                just list their file names here. This has to be 
  248.                                the last parameter. 
  249.       Value:                   List of files which should not be copied. 
  250.                                Seperate the single file names with spaces. 
  251.                                There can be any number of files listed. 
  252.       Default:                 All files are copied, no files are excluded. 
  253.  
  254.      Examples 
  255.  
  256.             install unattendedinstallation=true logfile=s:\install.log targetfolder="<WP_DESKTOP>" cmdline="-t"
  257.             install os2drive=y destpath=y:\ssaver installdos=false installwinos2=false createobject=false
  258.             install winos2path=z:\win31 excludefiles trek1.dss flame.ssm 3d.ssm puzzle.ssm
  259.  
  260.      Notes 
  261.  
  262.         -  The DOS fullscreen support file (SSDKICK.COM) is copied to the 
  263.            directory x:\OS2\MDOS and the line "x:\OS2\MDOS\SSDKICK.COM 5" is 
  264.            inserted into the x:\AUTOEXEC.BAT file. 
  265.         -  The Win-OS/2 fullscreen support file (SSWKICK.SCR) is copied to the 
  266.            Windows directory and the line 
  267.            "SCRNSAVE.EXE=w:\windowspath\sswkick.scr" is added to the [boot] 
  268.            section of the SYSTEM.INI file. 
  269.         -  If fullscreen support for a session type is not installed, the above 
  270.            changes are not made and the files are not copied. 
  271.  
  272.      List of modules 
  273.  
  274.       To exclude a module from installation, just list its file name after the 
  275.       EXCLUDEFILES parameter. 
  276.  
  277.       file name:               module name: 
  278.  
  279.       Deskpic modules: 
  280.  
  281.       ACIDRAIN.DSS             Acid Rain [Deskpic] 
  282.       AQUARIUM.DSS             Aquarium [Deskpic] 
  283.       BLOCKS.DSS               Blocks [Deskpic] 
  284.       BOUNCE.DSS               Bounce [Deskpic] 
  285.       BUSYBEES.DSS             BusyBees [Deskpic] 
  286.       CLOCK.DSS                Clock [Deskpic] 
  287.       EYES.DSS                 Eyes [Deskpic] 
  288.       FIRE.DSS                 Fireworks [Deskpic] 
  289.       FLASH.DSS                Flashlight [Deskpic] 
  290.       KALSCOPE.DSS             Kaleidoscope [Deskpic] 
  291.       MELT.DSS                 Melting screen [Deskpic] 
  292.       NEWPOLY.DSS              Fading Polygons [Deskpic] 
  293.       OS22BOUN.DSS             OS/2 v2.0 Bounce [Deskpic] 
  294.       OS2BOUNC.DSS             OS/2 Bounce [Deskpic] 
  295.       POLYGONS.DSS             Polygons [Deskpic] 
  296.       PUZZLE.DSS               Puzzle [Deskpic] 
  297.       PUZZLE2.DSS              The Puzzle II [Deskpic] 
  298.       RADAR.DSS                Radar [Deskpic] 
  299.       RAIN.DSS                 Rain [Deskpic] 
  300.       SHRINK.DSS               The Shrink [Deskpic] 
  301.       SMARTIES.DSS             Smarties [Deskpic] 
  302.       SPHERES.DSS              Spheres [Deskpic] 
  303.       SPLINES.DSS              Splines [Deskpic] 
  304.       STRING.DSS               String [Deskpic] 
  305.       SWARM.DSS                Swarm [Deskpic] 
  306.       TREK1.DSS                Star Trek 1 [Deskpic] 
  307.       WALL.DSS                 Wallpaper [Deskpic] 
  308.       WORM.DSS                 Worm [Deskpic] 
  309.  
  310.       ScreenSaver modules: 
  311.  
  312.       3D.SSM                   3 Dimensions 
  313.       BANNER.SSM               Banner 
  314.       BITMAP.SSM               Bitmap 
  315.       BLANK.SSM                Blank 
  316.       CLOCK.SSM                Clock 
  317.       COLORS.SSM               Colors 
  318.       DIMMER.SSM               Dimmer 
  319.       FADE.SSM                 Fade To Black 
  320.       FLAME.SSM                Flame 
  321.       FORTUNES.SSM             Fortunes 
  322.       HOPALONG.SSM             Hopalong 
  323.       ICON.SSM                 Icon Spiral 
  324.       IMAGE.SSM                Image 
  325.       IRONMAID.SSM             Iron Maiden 
  326.       LENSE.SSM                Lense 
  327.       LIFE.SSM                 Life 
  328.       LINES.SSM                Lines 
  329.       MEALSTRM.SSM             Mealstorm 
  330.       OVERTIME.SSM             Working Overtime 
  331.       PUZZLE.SSM               Puzzle 
  332.       PYRAMIDS.SSM             Pyramids 
  333.       PYRO.SSM                 Pyro 
  334.       QIX.SSM                  Qix 
  335.       ROTOR.SSM                Rotor 
  336.       SLIDES.SSM               Slideshow 
  337.       SPOT.SSM                 Spot 
  338.       STARS.SSM                Starflight 
  339.       SWARM.SSM                Swarm 
  340.       WORM.SSM                 Worm 
  341.  
  342.  
  343. ΓòÉΓòÉΓòÉ 4. Uninstalling ScreenSaver ΓòÉΓòÉΓòÉ
  344.  
  345. If you want to completely remove ScreenSaver, do the following: 
  346.  
  347.    1. Exit ScreenSaver (choose Close from the window list) 
  348.    2. Delete the file SSWKICK.SCR from your windows directory 
  349.    3. Delete the file SSDKICK.COM from the \OS2\MDOS directory 
  350.    4. Remove the line "\OS2\MDOS\SSDKICK x" from your AUTOEXEC.BAT file 
  351.    5. Remove the program object from the OS/2 startup folder 
  352.    6. Delete all the files in the SSAVER directory 
  353.    7. If deleting all files fails (OS/2 may have locked some files), reboot and 
  354.       try again to delete all files in the SSAVER directory 
  355.    8. Remove the SSAVER directory 
  356.